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INTRODUCTION: 


MAIL LIST provides the user with the capability -of 
creating, accessing and modifying data files consisting 
of names, addresses and key codes. Each entry consists 
of a line containing a user-defined key code (or codes) 
followed by up to five additional lines of address or 
other information. 


MAIL LIST is an extremely versatile data manager. 
Names are easily added to or deleted from your files. 
Entries can be retrieved by name, keyword(s) or by zip 
codes. They can be written to a printer or to another 
file for complete file management. The program will 
produce address labels (either 1, 2 or 3-up) and will 
sort alphabetically or by zip code. MAIL LIST is also 
capable of finding and deleting duplicate entries 
automatically. 

The file structure used in MAIL LIST was selected to 
maximize the number of entries which can be stored on 
one disk. You will find that upwards of 1200 addresses 
can be stored on one side of a single density disk, and 
that over 2400 entries can typically be stored on a 
double density disk. 


GETTING STARTED: 


'Your MAIL LIST disk contains two programs, MLIST and 
SORT. MLIST is the file name for the full MAIL LIST 
program. SORT is an abridged version of MAIL LIST and 
consists only of alphabetic and zip code sorting 
routines. It is meant to be used with a computer 
system having a minimum amount of free memory. As 
supplied on your disk, MLIST is dimensioned to sort up 
to 500 entries. Note that this restriction applies 
only to sorting , the total number of entries which can 
be accessed is not memory limited. SORT is dimensioned 
to handle up to 1500 entries. You can easily change 
the sorting capacity of these programs by 

re-dimensioning the variables M and S in line 18 of 
either program. If you have a full complement of 
memory, you should be able to change the dimensions of 
these two variables from 500 to 1500 (or higher) in the 
MLIST program. The more memory available, the more 

items which can be sorted. 


To load the program from disk, first boot up your 
system using your computer's master disk. Enter BASIC 
and then load the program using your computer's normal 
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LOAD command; i.e., for North Star or Apple, type LOAD 
MLIST; for Atari, use LOAD"D:MLIST"; for CP/M systems, 
use LOAD"A:MLIST" etc. (North Star users should 
remember to use the MEMSET command to free enough 
memory for proper program operation). When loaded, 
type RUN. The program will sign-on and prompt you to 
enter a file name. Enter any legal name. If the file 
already exists, you will be able to access its entries 
or add to the file. If the file does not yet exist, it 
will be created as soon as you input your first entry. 
In the case of North Star, all data files must be 
created beforehand. Use the CREATE command from BASIC 
to build a type 3 file large enough to handle the 
anticipated number of entries. Assume 3.3 entries per 
block. 

After entering the data file name, you will be prompted 
to select an option. To view the option menu, enter 
'O' as your option. See Figure 1 for an example of a 
typical start-up dialog. 


EXPLANATIONS OF OPTION CODES: 


File Building Options: START 

A 

The START option and A option are the two codes used to 
create and add to your data files. You must use START 
to create the initial entries to a data file. If you 
wish to add additional entries to files which already 
exist, you must use the A option. 

The START option always writes the entries at the 
beginning of the designated file. If the file already 
has entries in it, use of the START option will cause 
those entries to be overwritten and therefore lost. 
The A option reads through a file until it finds the 
last entry and then begins writing the new entries at 
that location, thereby preserving all previous data. 

0 USE START TO WRITE TO AN EMPTY FILE OR TO 
OVERWRITE AN EXISTING FILE. 

o USE A TO ADD TO THE END OF AN EXISTING FILE. 

When writing to a file, you will be asked to enter a 
three character key (or keys). This key is required 
for all entries. If you do not wish to utilize a key, 
simply type in a dummy value. Note, however, that the 
key must be three characters in length otherwise a 
length error message will be printed. You will 
continue to get that message until you enter a three 
character key (or keys). 

You may string together up to 21 key words on the first 
line of your entry. Do not use delimiters between the 
keys and remember that the total length must be a 
multiple of three. 
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Figure 1 : Typical program start-up. 


LOAD MLIST 

READY 

RUN 


MAIL LIST 
rel 2.2 


(C) 1981 by DYNACOMP,Inc. 
Rochester , NY 14618 


TYPE 


FOR OPTION LIST. 


OPEN WHAT FILE? TEMP 


ENTER OPTION: 0 


<<< OPTION CODES >>> 


START 

= 

START NEW FILE 

N 

= 

NAME SEARCH 

A 

= 

ADD TO LIST 

K 

= 

KEYWORD SEARCH 

DF 

= 

DELETE WITH FLAG 

R 

= 

REVIEW LIST 

DP 

= 

PURGE FLAGGED ENTRIES 

W 

= 

WRITE LIST 

DUP 

= 

DELETE DUPLICATES 

M 

= 

MERGE FILES 

ABC 

= 

ALPHABETIZE 

Z 

= 

ZIP CODE SORT 

STEP 

= 

STEP THROUGH LIST 

F 

= 

OPEN NEW FILE 

OUT 

= 

SELECT OUTPUT DEVICE 

(F) 


= FILE SUFFIX 

(W) 

= 

WRITE SUFFIX 

(L) 


= LIST SUFFIX 

ENTER 

OPTION: START 





Enter your 3-character code(s) followed by 
no more than 5 lines of address information. 
Press 'RETURN 1 for the next entry. 

C0DE7BUS 

7ALTMAN f MS. JOYCE E. 

?DYNACOMP,INC. 

?1427 MONROE AVENUE 
7ROCHESTER, NY 14618 
*? 

C0DE7FAM 

?STEIN,KEVIN 
?31 HILLRISE DRIVE 
7PENFIELD, NY 14628 
•? 

CODE? 


ENTER OPTION: 
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These are valid keys: 

AAA 

AAABBB 

X13B72X12AA5 

#$%N&*+/? 

These are not: 

AAAA 
AAA,BBB 
X13B72X12,AA5 
AAA BBB CCC 

Systems running with Microsoft BASIC (Apple, CP/M, 
TRS-80 etc.) should not use a comma as a character in 
the keyword. 

The next line to be entered should contain the name 
under which the entry will be filed. You may use a 
personal name or corporate. Personal names should be 
entered last name first followed by a comma and then 
the first part of the name. Do not use more than one 
comma on this line. 

The remaining lines are used for the address 
information. You may add as few as two additional or 
up to four more lines depending upon the address. 

Lets take an example. Customer John Doe Jr. purchases 
three items from you. Your codes for these items are 
AX1, BY2 and CZ3. The entry to the list will have the 
following form: 

CODE7AX1BY2CZ3 

?DOE JR.,MR. JOHN D. 

?123 ELM STREET 

7WEBSTER, NEW YORK 14580 

7 

CODE? 

Note that any desired information can be entered on the 
first line (e.g., phone numbers or birth dates), but 
the total number of characters must be a multiple of 
three. 

The second line contains the name. Entries are stored 
last name first in order to facilitate the name search 
which is carried out relative to the last name. 
However, when printed out, the order is first name 
first and last name last. Thus the name used in the 
above example would print out as: 

MR. JOHN D. DOE JR. 

IMPORTANT : An entry consisting of a person"s name MUST 

contain a comma! The comma is used as a deliminator 
and is required for program operations. The program 
searches the name line for the comma, stores the string 
found before the comma and then prints that string 
after first printing out the string found to the right 
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of the comma. In the above example, the first string 
(to the left of the comma) is: DOE JIJ. The program 
stores that string as a temporary string variable and 
prints out MR. JOHN D. (the string to the right of the 
comma). It then prints Mr. DOE's last name and the Jr. 
For those situations where you have only a one-name 
entry, the comma would not be needed. In general, with 
multi-worded inputs, place the most important word 
before the comma. If there is no one essential word, 
then no comma is needed. Note that if you entered a 
corporate name such as "DYNACOMP,INC.", that entry 
would be printed out as "INC. DYNACOMP"! Do not use 
the comma in such cases. Optional address information 
(such as c/o etc.) can be added on the lines below the 
name, entry. These entries are straightforward. Enter 
the information as you would like it to appear on the 
printout. Note however, that in order to facilitate 
searches for zip codes, the zip codemust be the very 
last item entered on the last line of the entry. 

If you make a mistake when typing in your entries, use 
your computer's delete function to correct any errors 
on the current line. If you have already entered that 
line, you may redo the entry by typing two dollar signs 
($$) at the beginning of any line after the name line. 
MAIL LIST will then disregard what you have already 
typed and give you the "CODE?" prompt over again. 


C0DE7FAM 

7M0RGAN,ERIC 
?16G0RDAN PLCE 
?$$ 

C0DE7FAM 

7M0RGAN,ERIC 
?16 GORDAN PLACE 
?FAIR LAWN, NJ 07410 
7 

CODE? 


W hen you have, completed inputt i ng your_names into 

the 1ist,. you exit the entry mode by simply pressing 

the RETURN (or ENTER) key when asked "CODE?". When you 
desire to add more entries to your file, you must use 
the A option. Your new entries will then be added to 
the list after the entries already present in the file. 
The mode of entry is exactly the same as with the START 
option. 

Note to Apple users: to optimize disk I/O response 
times, you will find that MAIL LIST converts all commas 
in the name line to semi colons. Any comma entered in 
the remaining address lines will be replaced by a space 
when printed out. 



Delete Options: 


DF 

DP 

DUP 
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These options allow entries to be removed from the data 
file. When an entry is to be deleted, use the DF 
(Delete with Flag) option. You will then be asked what 
name the entry is to be found under. Enter the 
appropriate name (last name) and the file will be 
searched until that name is found. You will then be 
asked whether to delete that entry or not. If NO, then 
the search will be continued until the proper entry is 
found or the end of the file is encountered. If the 
answer is YES , the deletion is accomplished by 
overwriting the first three characters of the key line 
with three periods (”..."). This action renders the 
entry invisible to any subsequent action; it will not 
be printed out or sorted, though it still occupies 
physical space on the disk. 

To maximize file space, deleted (flagged) entries may 
be physically purged from a data file by using the DP 
(Delete with Purge) option. This causes the file to be 
written to another file. Whenever an entry having 
"...” as its first key is encountered, that entry is 
not written to the new file. The new file therefore 
will contain only the up-to-date entries, not the 
deleted entries. 

Note that when using DP with a single drive system, 
there must be space on the disk for two data files: 
the source file and the destination file. With a 
multi-drive system the source and destination files can 
be on different disks thereby allowing maximum file 
size. 

The DUP option is used to remove duplicate entries from 
a data file. It operates by comparing each entry to 
the preceding entry. If the names and zip codes for 
both entries are the same, then the second entry is 
presumed to be a duplicate and is not written to a 
destination file. In order for the DUP option to work 
properly, the source file must be in either alphabetic 
or zip code order (see sections on the ABC and Z 
options). You will be requested to enter a destination 
file name. The program will read the entries from your 
source file and write the non-duplicates to the 
destination file. When finished, you will be informed 
as to the number of duplicates that were deleted. For 
maximum efficiency, this option should be run twice. 
Use DUP on an alphabetized list first. Use the 
resulting file for a zip code sort and then run DUP on 
that file. This procedure will maximize the 
probability that most duplicates will be found and 
removed. 
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Sort Options: ABC 
Z 

The usefulness of a mail list is enhanced when that 
list can be sorted alphabetically by name or 
geographically by zip code. Alphabetical listings are 
obtained using the option ABC. This option will 
produce a listing alphabetized over the first four to 
six characters found on the second (name) line of each 
entry. Note that since the sort is carried out on the 
ASCII values of the characters, upper case letters will 
be sorted differently from lower case. If alphabetized 
lists are important to you, it is suggested that you 
use either all upper case letters or all lower case 
letters (with the exception of the first character of 
each word which should be capitalized). Try not to mix 
the two styles of entry. 

The use of the Z option will provide you with two 
selections, a zip code search or zip code sort. The 
search will print out all entries having the zip code 
or zip code range which you specify. The sort will 
provide a printout of entries listed in ascending zip 
code order. Those entries not having zip codes 
(foreign countries) or having invalid codes will be 
printed at the beginning of the list. 


Search Options: K 
N 
Z 

Each entry to your list is given one or more 
identifiers called keys. By specifying the K option, 
all entries having a particular key or set of keys, 
will be printed out. For instance, you may use the key 
"OCT” for all entries needing some action taken during 
the month of October, and the key "JUN" for the month 
of June. When specifying the K option, you will be 

prompted for a keyword. If you enter JUN, then all 

entries having the key JUN somewhere in the first line, 
will be printed out. You could also enter JUNOCT as 

the key and all entries having JUN and OCT in the key 

line will then be printed out. 

To obtain the listing for a particular name, use the N 
option. You will be prompted for the name and then all 
entries having that name will be printed out. Note 
that the search is conducted on the last name. If you 
wish to print out all entries whose names begin with a 
given letter, simply enter that letter in response to 
the NAME prompt. 
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ENTER OPTION: N 

ENTER NAME: STEIN 
FAM 

KEVIN STEIN 
31 HILLRISE DRIVE 
PENFIELD, NY 14628 

1 ENTRIES PRINTED. 


The Z option can be used for searching for entries 
having a given zip code or zip code range. After 
entering Z as your option, you will be asked whether 
you want a zip code sort or search (see previous 
section on sorting). Enter SE (search) and then when 
prompted, enter the desired zip code range. All 1 

entries falling between the specified zip codes will 
then be displayed. If you desire to print out entries 
having a specific zip code, enter that zip code as both 
the "lowest" and "highest" zip codes. 


ENTER OPTION: Z 

ZIP CODE SORT (SO) OR SEARCH (SE)? SE 

ENTER ZIP CODE RANGE, LOW TO HIGH. 
LOWEST ZIP CODE? 14600 
HIGHEST ZIP CODE? 14700 
DEFEAT KEYWORD PRINTOUT? Y 


MS. JOYCE E. ALTMAN 
DYNACOMP,INC• 

1427 MONROE AVENUE 
ROCHESTER, NY 14618 

KEVIN STEIN 
31 HILLRISE DRIVE 
PENFIELD, NY 14628 

2 ENTRIES PRINTED. 


Printout Options: R 
W 

(W) 

(L) 


The R and W options: 

The printout options allow the entire contents of a 
data file to be printed in several formats. Both the R 
and W options will print all entries in the order in 
which they appear in the file. The R option prints 
each entry one after another with one line bewteen 
listings. The R option also gives you the option of 
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printing out the key words or not. The W option lists 
the entire file also but extra lines are automatically 
inserted beteen entries in order to provide the proper 
format for printing to 15/16" address labels. See 
Figure 2 for the difference between the two outputs. 

When selecting the W option, you are also given the 
choice of choosing l f 2 or 3-up label formats. In 
choosing the 2 or 3-up options, you may have to modify 
the code slightly in order to properly space the 
addresses. See line 15, variables T4 and T5. The 
values for those variables are the columns at which the 
second and third addresses will be printed. 

When using the W option, make sure that your printhead 
is positioned at the top line of a label. You may have 
to experiment with positioning in order to get the 
printout to fit properly on the label stock. 


The (W) and (L) suffices: 

The (W) and (L) suffices can be appended to most 
options to give additional printout flexibility. The 
(L) suffix will produce printout in which each entry is 
printed on one line. This is used as a space or paper 
conservation convenience. When the (W) suffix is 
appended to an option, the resulting printout will be 
spaced properly for writing 1-up address labels. 

For instance, you desire an informational printout of 
all entries having the key FAM and you want each entry 
printed in a space saving format. Use the option KL 
(we simply add L to the K option code): 


ENTER OPTION: KL 
ENTER KEYWORD(S): FAM 
DEFEAT KEYWORD PRINTOUT? Y 

STEIN,KEVIN / 31 HILLRISE DRIVE / PENFIELD, NY 14628 
MORGAN,ERIC / 16 GORDON PLACE / FAIR LAWN, NJ 07410 


2 ENTRIES PRINTED. 


Now suppose you wish to mail information to all entries 
having the key AX1. Simply add the (W) suffix to the K 
option: KW. All entries found with that keyword will 
be printed out with proper spacing for label stock. 

Note that use of the (W) suffix with the R option is 
redundant since the result would be the same as using 
the W option by itself. 
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Figure 2 : Difference between W and R options. 


ENTER OPTION: W 

1, 2 OR 3-UP LABELS? 1 


MS. JOYCE E. ALTMAN 
DYNACOMP f INC. 

1427 MONROE AVENUE 
ROCHESTER, NY 14618 


KEVIN STEIN 
31 HILLRISE DRIVE 
PENFIELD, NY 14628 


MR. JOHN D. DOE JR. 
123 ELM STREET 
WEBSTER, NY 14580 


ERIC MORGAN 
16 GORDAN PLACE 
FAIR LAWN, NJ 07410 


ALLEN DENNY 
188 RUTGERS STREET 
OTTAWA, ONTARIO 
CANADA K2E 7J1 

MR. A. DALEY 

PRESIDENT 

AJAX CARTING CO. 

587 MULLER ST. 
ROCHESTER, NY 14608 


ENTER OPTION: R 

DEFEAT KEYWORD PRINTOUT7Y 


MS. JOYCE E. ALTMAN 
DYNACOMP,INC• 

1427 MONROE AVENUE 
ROCHESTER, NY 14618 

KEVIN STEIN 
31 HILLRISE DRIVE 
PENFIELD, NY 14628 

MR. JOHN D. DOE JR. 

123 ELM STREET 
WEBSTER, NY 14580 

ERIC MORGAN 
16 GORDAN PLACE 
FAIR LAWN, NJ 07410 

ALLEN DENNY 
188 RUTGERS STREET 
OTTAWA, ONTARIO 
CANADA K2E 7J1 

MR. A. DALEY 

PRESIDENT 

AJAX CARTING CO. 

587 MULLER ST. 

ROCHESTER, NY 14608 

MR. AND MRS. MARK MISHLER 
65 SHIREWOOD DRIVE 
ROCHESTER, NY 14624 


7 ENTRIES PRINTED. 


ENTER OPTION: 


MR. AND MRS. MARK MISHLER 
65 SHIREWOOD DRIVE 
ROCHESTER, NY 14624 


7 ENTRIES PRINTED. 


ENTER OPTION: 
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Convenience options: M 

OUT 

STEP 

(F) 

The M option (Merge) allows you to write one file over 
another or to merge one file onto the end of another. 
When compiling a long list in which entries are made 
during separate sessions, it is recommended that a 
temporary file be used for the new entries. When all 
entries are completed, the contents of the temporary 
file may then be merged to the primary file. This 
procedure serves two purposes; the more important being 
that valuable files should not be written to any more 
than necessary. A secondary reason is that a mistake 
can be deleted more quickly from a short file than from 
a long one. 

When merging files, you must specify the destination 
file and inform the computer whether you wish to 
overwrite the contents of that file or add to the end 
of the file. You will be informed as to the number 
entries that were in the destination file before and 
after merging and the number of entries that were in 
the source file. 

ENTER OPTION: M 

DESTINATION FILE NAME? SCRATCH 

ADD TO THE END OF SCRATCH? Y 

FILE TEMP HAD 4 ENTRIES. 

FILE SCRATCH NOW HAS 21 ENTRIES. 


The OUT option is used to direct the ouput to a line 
printer or back to the monitor. After entering OUT, 
you will be asked: 

PRINTER (P) OR MONITOR (M)? 

Note that with the Apple computer, an additional 
question is asked pertaining to the slot number 
containing the parallel interface card. (Usually slot 
number 1. See subroutines at lines 8000 and 8100 for 
setting the number of columns printed). Other systems 
will handle the port assignments automatically. 

When the printer is selected, all data output will be 
sent to that device. However, all status statements 
and input prompts will continue being displayed on the 
monitor. To return to the monitor, select the OUT 
option again and enter M. 
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The STEP option provides the user with the ability to 
step through a file one entry at a time As each entry 
is displayed, any of the following operations can be 
performed: 

o When 'W' is depressed, the current entry 
will be printed in label format (Make 
sure that you have selected the printer 
using the OUT option in order to print 
on the address labels) . 

o 'D* will cause the entry to be deleted 
via the DF option. 

o 'F' will write the specified entry to 
another file. 

o 'RETURN' or any other key displays the 
next entry in the file. 

o 'Q' interupts the STEP execution and returns 
you to the "OPTION:" prompt. 


In most computer systems, these options are entered via 
the "live keyboard", i.e., you will not have to press 
the RETURN key to enter your selection. 


One of the most useful options in MAIL LIST is the (F) 
suffix. When appended to the appropriate option, this 
suffix will cause the resulting printout to be written 
to another file rather than to a display. For 
instance, you could use NF as an option to write all 
entries whose names start with a given letter to a 
separate file. You could do the same with zip codes 
(use 'ZF') or keywords ('KF'). 


ENTER OPTION: KF 
ENTER KEYWORD(S): FAM 


DESTINATION FILE NAME? SCRATCH 
ADD TO THE END OF SCRATCH? N 

*** WARNING!!! *** 

Any data contained in file SCRATCH will 
be overwritten. If this is acceptable, 
then press 'Y' otherwise, press 'RETURN'. 
?Y 


2 ENTRIES PRINTED. 
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Additional Comments: 


Program size: 

MAIL LIST is a relatively large program. If you find 
that you are getting "OUT OF MEMORY" errors , you can 
reduce the size of the program by changing the DIM 
statement in line 18. That line contains two 
variables, M and S, which are dimensioned as 500 
element arrays. These variables are used only for 
sorts and therefore can be reduced in size or 
eliminated altogether if you are not going to use the 
sort options (ABC and Z). If you are memory limited 
and still require the sorting ability, run the much 
shorter SORT program on your disk. If you have 
sufficient memory, you could, of course, increase the 
sorting capacity of MAIL LIST by making the M and S 
arrays larger in size. 


Other Uses: 


MAIL LIST can be used as a mini data based management 
system or as a computerized telephone directory. You 
could enter a phone number on the key line or on any 
line after the name line. In the same manner, you have 
up to five lines of information which you can store 
about a person or subject. MAIL LIST does not have to 
be used exclusively for mail lists! 

CODE?(716)-442-8960# 

?WALSH,ARTHUR M. 

7BIRTHDAY: JULY 30 

?HOBBIES: MUSIC, PHOTOGRAPHY, COMPUTERS 

70CCUPATI0N: MANAGER OF SOFTWARE PRODUCTS 

?MISC: MARRIED, 2 CHILDREN 


In Case of Trouble... 

It will happen! There will be an occasion when your 
data file has problems, either a hard disk error or 
something else which will render file usage difficult 
or impossible. The solution is clear: KEEP BACKUP 
COPIES OF ANY VALUABLE FILES! Also, do not write 
directly to a valuable file. Use a temporary file and 
then merge the two files. 

If you have a file which produces an error during 
listing, all entries prior to the error can be saved 
onto another file by using the M option (This method 
however, will not work for the Apple). 
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Zip Codes, 5 or 9 digits? 

MAIL LIST is set up for a 5 digit zip code. You can 
modify the program very easily to handle any length zip 
code by altering the value of Z5 in line 18 of the 
code. If you wish to handle a nine digit zip, change 
Z5=5 to Z5=9. 

Remember that when entering an address, MAIL LIST 
assumes that the last Z5 characters on the last line is 
the zip code. If any of those characters is not a 
number, then that entry will not be included in a zip 
code sort or search. Be sure not to add any spaces 
after entering a zip code as the space will be read as 
a non-numeric character causing that entry's zip code 
to be ignored. 


Multi-Drive Systems: 

Additional disk drives are easily accessed by MAIL 
LIST. Simply use the normal syntax supported by your 
computer system. For instance, if a file called DATA 
is to be read from drive number two, use one of the 
following file identifiers appropriate for your 
computer: 


DATA,2 
DATA,D2 
D2:DATA 
B:DATA 
etc. 


(North Star) 
(Apple) 
(Atari) 
(CP/M) 


Note that it is unnecessary to specify drive #1 after 
a file name as that is the default drive. 


File Compatibility: 

All files created by MAIL LIST are fully compatible 
with DYNACOMP's FORM LETTER SYSTEM and SORTIT programs. 



NOTES 



NOTES 





